home *** CD-ROM | disk | FTP | other *** search
/ Merciful 2 / Merciful - Disc 2.iso / software / l / lsddoc's_disk_063.dms / lsddoc's_disk_063.adf / PersonalWrite4.1.Ch05 / PersonalWrite4.1.Ch05
Text File  |  1995-11-20  |  74KB  |  1,610 lines

  1.  
  2.  "Personal Write 4.1 - 5. The Options Menu"
  3.  
  4.  5.  The Options Menu
  5.      5.1  Style
  6.      5.2  Format
  7.           5.2.1  Document Format
  8.                  5.2.1.1  Characters per Line
  9.                  5.2.1.2  Lines per Page
  10.                  5.2.1.3  Left Margin
  11.                  5.2.1.4  Top Margin
  12.                  5.2.1.5  Bottom Margin
  13.                  5.2.1.6  Header
  14.                  5.2.1.7  Page Numbering
  15.           5.2.2  Paragraph Format
  16.                  5.2.2.1  Additional Left and Right Margins
  17.                  5.2.2.2  Alignment
  18.                           5.2.2.2.1  Left
  19.                           5.2.2.2.2  Centred
  20.                           5.2.2.2.3  Right
  21.                           5.2.2.2.4  Justified
  22.                  5.2.2.3  Automatic Hyphenation
  23.      5.3  Printer
  24.           5.3.1  Automatic Font Selection
  25.           5.3.2  Letter Quality
  26.           5.3.3  Multi-Strike
  27.           5.3.4  Proportional Characters
  28.           5.3.5  Printer can Justify
  29.           5.3.6  Pitch
  30.           5.3.7  Line Spacing
  31.           5.3.8  Number of Copies
  32.           5.3.9  Pages
  33.           5.3.10 Skip Lines at Top of Page
  34.           5.3.11 Send Form Feed
  35.           5.3.12 Wait for Page Change
  36.           5.3.13 Use Printer Bell
  37.           5.3.14 Maximum Printer Buffer Size
  38.      5.4  PostScript
  39.           5.4.1  PostScript activated
  40.           5.4.2  Left Margin
  41.           5.4.3  Top Margin
  42.           5.4.4  Margin adjust unit
  43.           5.4.5  PostScript fonts
  44.      5.5  User Interface Colours
  45.      5.6  Picture Colours
  46.      5.7  Sounds
  47.      5.8  Language
  48.           5.8.1  Document Language
  49.           5.8.2  User Interface Language
  50.           5.8.3  Keyboard Language
  51.      5.9  Date and Time
  52.      5.10 Date Format
  53.           5.10.1 Order
  54.           5.10.2 Year Format
  55.           5.10.3 Month Format
  56.           5.10.4 Delimiter
  57.           5.10.5 Label Date
  58.      5.11 Number Format
  59.           5.11.1 Arabic Numerals
  60.           5.11.2 Roman Numerals
  61.      5.12 User Interface
  62.           5.12.1 Show Command Gadgets
  63.           5.12.2 Function Keys Activated
  64.           5.12.3 Auto-Repeat Delete Keys
  65.           5.12.4 Display Cursor Position
  66.           5.12.5 Show Paragraph signs
  67.           5.12.6 Text Display
  68.           5.12.7 Initial Date and Time Set
  69.           5.12.8 Hide Mouse Pointer
  70.           5.12.9 Workbench Screen
  71.     5.13  Video
  72.           5.13.1 Base Mode
  73.           5.13.2 Extended Mode
  74.           5.13.3 Vertical Refresh Rate
  75.           5.13.4 Frames per Second (A 2024)
  76.           5.13.5 Overscan Screen
  77.           5.13.6 Interlaced Screen
  78.     5.14  Save
  79.  
  80.  "Personal Write 4.1 - 5. The Options Menu"
  81.  
  82. 5.         The Options Menu
  83.  
  84.    Most functions and requesters which can be used to modify the working
  85. environment, the printer settings and the document and paragraph
  86. formattings can be selected from this menu.
  87.  
  88.    On the bottom right of each requester described in this chapter there
  89. is a CANCEL gadget. When this gadget is selected, all changes made in the
  90. requester are undone.
  91.  
  92.  
  93. 5.1        Style
  94.  
  95.    Six menu items can be used to select the desired character style.
  96. Section 1.13.7 illustrates the kind of changes which can be made to the
  97. character style.
  98.  
  99.    The menu items can be used to select the character style to be used
  100. after the command is executed, or to modify the style of all characters in
  101. a block. Section 3.1.7 explains how to define a style for all characters
  102. in a block
  103.  
  104.    A triangular checkmark can be displayed on the left of each menu item
  105. (plain, italic, bold, underlined, TEXT and LABEL). A checkmark means that
  106. the style associated with the menu item is currently activated (i.e. being
  107. used). Checkmarks are automatically updated when text is written or the
  108. block style is modified. To update the status of the checkmarks manually
  109. it is sufficient to move the pointer over the desired character in the
  110. text and double click the left mouse button.
  111.  
  112.    The LABEL and TEXT items are used to choose between real text and
  113. alphanumeric labels, displayed in red and replaced with text data when the
  114. document is printed. Sections 1.13.6 and 6.4.
  115.  
  116.    When the mouse is used to specify the character style, as described in
  117. section 1.17.2, the associated checkmarks are also updated. The selection
  118. of some items mutually excludes the possibility of having other items
  119. selected at the same time. The selection of the "Plain" text item excludes
  120. the italic, bold and underlined text styles. All combinations of these
  121. last three styles can be mixed at will. As with styles, a character cannot
  122. at the same time be real text and part of a label. The right mouse button
  123. must be held down during the selection (with the left button) of multiple
  124. menu items.
  125.  
  126.    If the menu items are selected while writing, the new style will be
  127. used for the text typed after the selection. If the selection is made
  128. after a "Set block style" command (section 3.1.7.1), the new style is
  129. immediately applied to the specified block.
  130.  
  131.    If, at different times, too many style commands are given, it may
  132. happen that it is not very obvious which of the given commands will have
  133. priority over the others in a given location of the text. The "Strip block
  134. style" command (section 3.1.7.2) can be very useful in these situations.
  135. When this command is executed, all style commands in the selected block
  136. are cleared. It is usually more convenient to write all the text with
  137. plain characters, and then use the "Set block style" function to modify
  138. the desired parts.
  139.  
  140.    When the cursor is moved to a new position in the text, the style
  141. previously selected in that point is used if new text is typed.
  142.  
  143.    Not all printers can print all the character styles described here.
  144. Some printers cannot print all combinations of the three styles. Most
  145. printers can print at least underlined and bold text. For example, some
  146. printers cannot print bold condensed (sections 5.3.6 and 6.4) or
  147. underlined italic text. Section 6.4 explains how control sequences can be
  148. embedded in the text to select superscripts, subscripts, colours and other
  149. text style functions.
  150.  
  151.    Each of the six menu items can be selected alone by pressing one of the
  152. following keys while <Amiga> is held down: <0> (plain), <1> (italic), <2>
  153. (bold) e <3> (underlined), <8> (TEXT> and <9> (LABEL).
  154.  
  155.  
  156. 5.2        Format
  157.  
  158.    Two different requesters can be used to modify the formatting of each
  159. paragraph or of the entire document.
  160.  
  161.    When a new document is created, or a text without formatting data is
  162. loaded, the default formatting values of Personal Write are used. The
  163. default values are always those which were last saved. In these
  164. circumstances, a text is considered a document of one paragraph,
  165. comprehending the whole text. There is always at least one paragraph.
  166.  
  167.  
  168. 5.2.1      Document Format
  169.  
  170.    The values which can be changed using this requester relate to an
  171. entire document.
  172.  
  173.    Some parameters modify only the printed text. Empty spaces between
  174. lines (line spacing), document left margin, and other elements, constant
  175. to all pages, are not displayed. Personal Write does guarantee that the
  176. beginning and end of a line on screen will be the same when printed. The
  177. same is valid for the beginning and end of pages. A horizontal green line
  178. is displayed between lines.
  179.  
  180.    When the PROCEED gadget is selected, Personal Write verifies whether
  181. the given values are compatible with one another. Different messages are
  182. used to signal that an error has occurred. Before PROCEED is selected
  183. again, the wrong values must be corrected. If CANCEL is selected, the
  184. values which were valid before the requester appeared are restored.
  185.  
  186.    When the new margins have been accepted, Personal Write modifes the
  187. additional left and right margins of the paragraphs which do not fit in
  188. the newly defined document format.
  189.  
  190.    The document is immediately reformatted using the new values.
  191.  
  192.  
  193. 5.2.1.1    Characters per Line
  194.  
  195.    This value represents the maximum number of characters per line, valid
  196. for an entire document. It is the width of the text, in characters. The
  197. left margin of the document is not included in this number, while
  198. additional left and right paragraph margins are.
  199.  
  200.    A message explaining the cause of the error (appendix D) is displayed
  201. if unacceptable values are typed. The maximum number of characters per
  202. line is 255. The minimum is 3, but the defined width must be able to
  203. contain a header or additional paragraph margins.
  204.  
  205.    The horizontal scrolling functions (sections 1.12.10 and 1.13.1) can be
  206. used if more characters per line are defined than those which fit on the
  207. screen.
  208.  
  209.  
  210. 5.2.1.2    Lines per Page
  211.  
  212.    This value indicates the number of lines which make up a page. If the
  213. value is set to zero the document is not divided into pages.
  214.  
  215.    The number of lines per page includes the top and bottom margins. For
  216. this reason the value must be greater than the sum of the two margins, if
  217. these are defined.
  218.  
  219.    On screen, pages are displayed separated by a horizontal green line.
  220. Top and bottom margins are not displayed.
  221.  
  222.  
  223. 5.2.1.3    Left Margin
  224.  
  225.    The left margin of the document consists of blank characters which are
  226. printed to the left of the document text. The spaces are neither displayed
  227. nor counted in the number of characters per line.
  228.  
  229.    Some printer drivers and/or printers may have problems handling texts
  230. in which the sum of the left margin plus the number of characters per line
  231. (section 5.2.1.1) exceeds 255.
  232.  
  233.  
  234. 5.2.1.4    Top Margin
  235.  
  236.    This value indicates how many blank lines are to be printed at the
  237. beginning of each page. These lines contain a page header and numbering,
  238. if either of these is defined.
  239.  
  240.    The value must obviously be smaller than the total number of lines per
  241. page. If a header or a page numbering on the top margin have been defined,
  242. the top margin must be at least 1. If both the header and the numbering
  243. are to be centred on the top margin, then the minimum value for the top
  244. margin is 2.
  245.  
  246.  
  247. 5.2.1.5    Bottom Margin
  248.  
  249.    This value defines the number of blank lines to be printed at the
  250. bottom of the page. These lines will be used to contain the page
  251. numbering, if it has been defined to appear at the bottom of the pages.
  252.  
  253.    The value must be smaller than the number of lines per page. If the
  254. page numbering is activated, and set to be on the bottom margin, then at
  255. least one line must be reserved for the bottom margin.
  256.  
  257.  
  258. 5.2.1.6    Header
  259.  
  260.    The header is a text which is displayed at the top of each page. The
  261. header can be placed on the left, right or at the centre of the first line
  262. of the top margin. If the same position is specified for both the
  263. numbering and the header, then the numbering will be printed more towards
  264. the border, compared to the header (but on the same line). If both the
  265. header and the page numbering are to be centred on the top margin, then
  266. the header will be centred on the first line, while the numbering will be
  267. printed at the centre of the second line of the top margin.
  268.  
  269.    If the string gadget is empty, no header is printed. Section 1.11.6
  270. explains how the content of the string gadget can be cleared quickly.
  271.  
  272.  
  273. 5.2.1.7    Page Numbering
  274.  
  275.    The page numbering consists of a progressive number which can be placed
  276. on each page.
  277.  
  278.    Several gadgets can be used to specify the margin and the position
  279. where the number is to appear. The numbers can be Arabic or Roman, in
  280. different formats, as described in section 5.11.2.
  281.  
  282.    Two string gadgets let the user define two characters which can be put
  283. immediately on the left and right of the number. One very useful option
  284. (the default in Personal Write) consists of embedding the number between
  285. two dashes, separated by spaces from the digits. Another common choice is
  286. to put the number between brackets.
  287.  
  288.    The number from which the numbering sequence on the printed text is to
  289. begin with can be defined with another string gadget. On the screen, the
  290. document always starts from page 1.
  291.  
  292.    The first page can be left without numbering. This can be useful, for
  293. example, if a printed letter head or a different format of paper is used
  294. for the first page.
  295.  
  296.  
  297. 5.2.2      Paragraph Format
  298.  
  299.    Different parts of the same document can have different formattings.
  300. The text from where a new formatting has to begin must be preceded by a
  301. paragraph sign, unless it is the beginning of the document. The new
  302. formatting affects the whole text down to the following paragraph with its
  303. own formatting data (if there is any). If this kind of formatting is
  304. enclosed by paragraph signs, it is described as paragraph formatting. In
  305. practice, any modifications to the paragraph formatting can modify the
  306. appearance of several successive paragraphs.
  307.  
  308.    It is more convenient to write a text first, and then define different
  309. paragraph formattings.
  310.  
  311.    The cursor must be positioned on the first character of the paragraph
  312. to be modified, before this command is given. This means that the cursor
  313. must be placed at the very left of the line immediately following a line
  314. terminating with a paragraph sign (or at the beginning of the document).
  315. If this is not done, Personal Write automatically places the cursor at the
  316. beginning of the paragraph whose data was used for the current
  317. formatting.
  318.  
  319.    After the command is given, Personal Write verifies if any formatting
  320. data is already associated with the specified position. If this is not the
  321. case, some memory is reserved to contain the new data. From that moment,
  322. all the text following the selected position will be formatted using the
  323. newly specified formatting data, until a paragraph with different data is
  324. found.
  325.  
  326.    A message informs the user that room for new paragraph data has been
  327. created.
  328.  
  329.    A red triangle is temporarily displayed to indicate the beginning of
  330. the paragraph whose formatting is being modified. At the same time, the
  331. requester appears.
  332.  
  333.    It is sufficient to modify the beginning of the text of the paragraph
  334. (e.g. deleting the first character after the paragarph sign) to remove the
  335. paragraph formatting data. The data of the first paragraph cannot be
  336. removed.
  337.  
  338.    If PROCEED is selected, the text is reformatted according to the new
  339. data, which has effect down to the line where different paragraph data has
  340. been defined. Memory reserved for newly created paragraph data is
  341. immediately freed if CANCEL is selected.
  342.  
  343.  
  344. 5.2.2.1    Additional Left and Right Margins
  345.  
  346.    These two values indicate by how many characters the text must be
  347. indented to the right or the left, in addition to the standard document
  348. margins.
  349.  
  350.    The sum of the two values must be such that at least three characters
  351. of usable line length (within the number of characters per line specified
  352. for the document) are left.
  353.  
  354.  
  355. 5.2.2.2    Alignment
  356.  
  357.    The text can be aligned in different ways. Four gadgets can be used to
  358. specify the type of alignment or formatting. On the screen title bar, on
  359. the right of the cursor position data, a single character is displayed to
  360. indicate the formatting for the text currently being written. In the
  361. English language version of Personal Write, this character is the first
  362. letter of the gadget associated with each formatting. A 'L' is displayed
  363. if the text is left aligned, a 'C' if the text is centred, an 'R' if the
  364. paragraph is aligned on the right, and a 'J' if the text is to be
  365. justified. The character automatically appears during text typing, but it
  366. can be displayed manually by double clicking the left mouse button when
  367. the pointer is over the text of which the user wishes to know the
  368. formatting.
  369.  
  370.  
  371. 5.2.2.2.1  Left
  372.  
  373.    The text is printed left-aligned, as it is displayed on the screen.
  374.  
  375.  
  376. 5.2.2.2.2  Centred
  377.  
  378.    The text is printed centred. Each line is centred between the paragraph
  379. (or document, by default) margins.
  380.  
  381.  
  382. 5.2.2.2.3  Right
  383.  
  384.    This is the opposite of the left-aligned text. The text is printed
  385. right-aligned.
  386.  
  387.  
  388. 5.2.2.2.4  Justified
  389.  
  390.    The text is printed justified. Depending on the printer settings,
  391. spaces are distributed between words and/or characters, until both margins
  392. are aligned.
  393.  
  394.    The last line of each paragraph, and all lines terminating with a
  395. paragraph sign, remain left-aligned. Depending on the current printer
  396. settings, a maximum of about one space character for each character of
  397. text in the line can be added. If these spaces are not sufficent to
  398. justify the text, then the line remains left-aligned.
  399.  
  400.    Spaces at the end of a line are skipped during the justification.
  401. Spaces at the beginning of a line are always printed.
  402.  
  403.  
  404. 5.2.2.3    Automatic Hyphenation
  405.  
  406.    This option is used to let Personal Write automatically hyphenate words
  407. at the end of a line. This function is not implemented in all the
  408. languages in which a document can be written.
  409.  
  410.    Blue dashes are displayed where Personal Write automatically divides a
  411. word. The dashes are printed normally as '-' signs.
  412.  
  413.    An entire word can be moved to the beginning of the line by manually
  414. inserting spaces immediately before the word.
  415.  
  416.    A '-' signed followed by a space character can be inserted where a word
  417. is to be manually truncated if it does not fit at the end of a line.
  418.  
  419.  
  420. 5.3        Printer
  421.  
  422.    This requester is used to control all printer settings. The printer
  423. handling routines of Personal Write are among the most flexible and
  424. powerful in their field.
  425.  
  426.    This function can be selected by pressing <Z> while the <Amiga> key is
  427. held down.
  428.  
  429.  
  430. 5.3.1      Automatic Font Selection
  431.  
  432.    This parameter is used to authorize (or forbid) Personal Write to send
  433. control codes to the printer to select the character type (font) and the
  434. line spacing.
  435.  
  436.    If the font is selected manually through the printer's control panel
  437. this parameter must be set to NO. If the character type or the line
  438. spacing are set within the printer control file, the value should also be
  439. set to NO. As described in section 4.3.5, on some printers the automatic
  440. font selection can be used to activate a downloaded font (if one exists).
  441.  
  442.    If the user forbids Personal Write to control the character type and
  443. the line spacing, the status of the letter quality, proportional
  444. characters, pitch and line spacing parameters are not taken into
  445. consideration.
  446.  
  447.  
  448. 5.3.2      Letter Quality
  449.  
  450.    The high quality letter mode of the printer is activated when this
  451. parameter is set to YES. On most impact printers the print speed is not
  452. the highest possible when this mode is set, but the difference in quality
  453. is evident.
  454.  
  455.    The faster and lower quality draft print mode is used if the parameter
  456. is set to NO.
  457.  
  458.  
  459. 5.3.3      Multi-Strike
  460.  
  461.    This parameter controls the number of times the printer head has to
  462. pass over each line to be printed. By setting this value appropriately,
  463. the print quality can be improved even more than with the function
  464. described in the previous section 5.3.2. If the value is greater than 0,
  465. the printer head prints each line of text in more than one pass. If the
  466. value is set to 1, the internal double-strike mode of the printer is
  467. activated. A value greater than 1 will instruct Personal Write to print
  468. the specified number of times the same text. The result will be an
  469. appreciable improvement in the print quality, especially on economical
  470. printers, or if the ribbon is out of ink. Some printers will move the
  471. paper slightly upwards between the "strikes".
  472.  
  473.  
  474. 5.3.4      Proportional Characters
  475.  
  476.    Some printers can print text using inter-character spacings which are
  477. proportional to the real width of the characters used. Proportionally
  478. spaced characters occupy a different space on the paper, depending on
  479. their real width. An 'I' character will therefore occupy less space than
  480. an 'M'. Depending on the characters used by the printer, the use of
  481. proportional versus fixed-width characters will result in more or less
  482. evident quality improvement.
  483.  
  484.    The automatic justification must be activated if proportional
  485. characters are used. Only the printer can format proportionally spaced
  486. text properly, unless it is all left-aligned. Some printers can use
  487. proportional characters, but cannot justify the text printed with these
  488. characters. In these cases, the text printed with proportional characters
  489. must be left-aligned to be formatted properly.
  490.  
  491.    The "Proportional adjust" parameter is used to define the average width
  492. of proportional characters, compared to that of fixed-width characters.
  493. Proportional characters are usually thinner, on average, than their
  494. fixed-width equivalent. The value in the string gadget indicates how many
  495. fixed width characters would occupy the same space as an average
  496. 100-character line of proportionally spaced text. This information is used
  497. by Personal Write to set the document margins. A value of 85% is usually
  498. sufficient to eliminate any excess white space in justified text,
  499. narrowing the margins. If the value exceeds 100%, the margins will be
  500. widened, increasing the number of spaces which will have to be inserted in
  501. the text to justify it.
  502.  
  503.    Print quality can be significantly improved setting this value
  504. appropriately. Some printers do not accept values of less than 100%. Most
  505. printers use a standard unit, typically one tenth of an inch, to set the
  506. margins, while others use the width of the space character of the current
  507. (proportional) font for that purpose. In this latter case, if the space
  508. character is very narrow, a value of 200% or more may have to be used.
  509.  
  510.  
  511. 5.3.5      Printer can Justify
  512.  
  513.    Justification (here intended as formatting) of the text can be carried
  514. out by Personal Write or by the printer. If the "Printer can Justify"
  515. option is activated, the program will send special commands to the printer
  516. to let the printer automatically format the text. Otherwise, Personal
  517. Write will format the text distributing white spaces as necessary. This
  518. option must be set to YES if centred, right-aligned or justified text is
  519. to be printed with proportional characters.
  520.  
  521.    Most printers will insert spaces both between words and between the
  522. letters of each word (micro spaces) to justify the text.
  523.  
  524.    If the automatic (i.e. done by the printer) justification is not
  525. activated, Personal Write uses internal algorithms to format the lines of
  526. text to be sent to the printer. When justifying text, the program tries to
  527. avoid the grouping of white spaces too regularly in the same positions. No
  528. spaces are inserted between letters in words.
  529.  
  530.    Automatic justification may not work properly on some printers if the
  531. automatic font selection is not activated as well. Not all printers can
  532. format the text. Some printers cannot centre the text automatically.
  533.  
  534.    Extremely high quality text output on impact printers can be obtained
  535. by setting the first YES/NO printer options to YES, "Multi-Strike" to a
  536. value of one or higher and carefully adjusting "Proportional Adjust". As a
  537. practical example, "Multi-Strike" should be set to 1 (one), and
  538. "Proportional Adjust" to 85% on the NEC Pinwriter printer series (the
  539. "Nec_Pinwriter" printer driver can be selected from the Amiga
  540. Preferences).
  541.  
  542.  
  543. 5.3.6      Pitch
  544.  
  545.    Most printers can use different print pitches, i.e. characters of
  546. different sizes. Personal Write allows the user to choose the size of the
  547. characters. The pitch is usually independent from the letter quality and
  548. proportional spacing mode. This means that different combinations of
  549. characters, pitches and print modes are possible.
  550.  
  551.    The characters chosen through the Preferences program are used if the
  552. PREFERENCES gadget is selected. Wide characters, at a pitch of about 5 cpi
  553. (5 characters per inch) are used if LARGE is selected. If PICA is
  554. selected, the text will be printed at about 10 cpi, while 12 cpi is the
  555. usual pitch associated with the ELITE mode. FINE activates the condensed
  556. print mode, at about 15 to 17 (or 17.1) cpi. It should be noted that some
  557. printers have internal fonts named "Pica" or "Elite", which have nothing
  558. to do with the same names in Amiga terminology (which are only used to
  559. identify different pitches).
  560.  
  561.    The printer pitches may vary slightly on different printers. Not all
  562. printers can work with all of the above described pitches. Some drivers
  563. will not allow the user to use all of the pitches. Section 6.4 explains
  564. how control sequences can be embedded in the text to select superscripts,
  565. subscripts, colours and other text style functions.
  566.  
  567.  
  568. 5.3.7      Line Spacing
  569.  
  570.    Two values are taken into account to compute the line spacing: the base
  571. step, which can be selected with the gadgets, and a multiplier, that is a
  572. number (which can be written in the string gadget) by which the base step
  573. is multiplied. Between two adjacent lines of text there will be as many
  574. base steps as indicated in the string gadget of the multiplier.
  575.  
  576.    Four gadgets can be used to select the line spacing unit (the base
  577. step). If PREFERENCES is selected, the unit is to be defined using the
  578. Preferences program. The remaining three gadgets are respectively
  579. associated with the following steps: one sixth of an inch (1/6"), one
  580. eighth of an inch (1/8") and one centimetre (1 cm).
  581.  
  582.    If the multiplier is 1, the line spacing is the same as the base step.
  583. If the multiplier is 2, then the spacing will be two times the selected
  584. unit, and so on. The multiplier is the only value of the printer settings
  585. which is always saved and loaded with the document format data.
  586.  
  587.  
  588. 5.3.8      Number of Copies
  589.  
  590.    This parameter indicates how many copies have to be printed. The number
  591. of copies is used by every print function. If the whole document is
  592. printed, then the specified number of copies will be printed. The same
  593. will happen when a page, block, file or picture is printed.
  594.  
  595.    When printing self-adhesive labels, personalized letters or other kinds
  596. of texts where data has to be read from a file to replace alphanumeric
  597. labels, the number of copies must be at least equal to the number of
  598. records in the data file (if all the records need to be used). Personal
  599. Write automatically stops printing if all records are used before the
  600. specified number of copies is printed.
  601.  
  602.  
  603. 5.3.9      Pages
  604.  
  605.    This parameter is used to specify the pages which are to be printed
  606. during a document print operation (sections 4.3.1 and 4.3.2).
  607.  
  608.    It is possible to exclude all odd or even numbered pages from the
  609. print. The page numbering, starting from the first page number specified
  610. in the document formatting data, is used to calculate the pages which are
  611. to be printed.
  612.  
  613.    This function is useful when long texts, with different styles for
  614. right and left side pages, have to be printed.
  615.  
  616.  
  617. 5.3.10     Skip Lines at Top of Page
  618.  
  619.    The number of lines to be skipped at the top of each sheet is indicated
  620. by this parameter. This can be especially useful if an automatic sheet
  621. feeder is used, but the print never has to start at the very top of the
  622. paper sheet (e.g. in order not to print over a letter head).
  623.  
  624.    The value is expressed in the same units used for the line spacing. The
  625. value is completely independent from the document parameters (top margin,
  626. lines per page, etc.).
  627.  
  628.    Each sheet will be moved up by the specified number of lines before the
  629. actual print begins. The function is active in both text and graphics
  630. print, but not in the "Print File" function.
  631.  
  632.  
  633. 5.3.11     Send Form Feed
  634.  
  635.    This option controls the sending of the Form Feed (FF, ASCII code 12)
  636. control code to the printer after each printed page and/or at the end of
  637. the printing.
  638.  
  639.    If single sheets are used, the paper is completely ejected after the
  640. form feed code is sent to the printer. On most printers a new sheet is
  641. automatically inserted if an automatic sheet feeder is mounted.
  642.  
  643.    The printer head automatically moves to the beginning of the following
  644. sheet if continuous forms are used. The documentation of the printer and
  645. the Amiga explain how to specify the page size of continuous forms.
  646.  
  647.    Not all printers handle the Form Feed control code in the same way. The
  648. size of the paper sheet (usually 11 or 12 inches) must be set on the
  649. printer. This can usually be done from the printer's control panel or by
  650. setting some switches. The paper must be positioned so that the printer
  651. head is over the first line when the printer is switched on.
  652.  
  653.  
  654. 5.3.12     Wait for Page Change
  655.  
  656.    Personal Write displays a message requester when a new sheet is to be
  657. inserted in the printer, if this option is activated. Printing is
  658. temporarily suspended until the PROCEED gadget in the requester is
  659. selected (or the <Help> key is pressed). If the ABORT gadget is selected,
  660. printing will be aborted, after a warning message has been displayed to
  661. avoid mistakes. In this way, the paper can be inserted without hurry, or
  662. printing can be suspended and continued later on with the "Print from
  663. Page" command (section 4.3.2).
  664.  
  665.    If both the form feed control code and the "Wait for Page Change" are
  666. activated, the FF code is sent to the printer before the message is
  667. displayed.
  668.  
  669.  
  670. 5.3.13     Use Printer Bell
  671.  
  672.    Some printers have an internal speaker. If this option is activated,
  673. Personal Write will try to activate the printer's bell briefly whenever
  674. the printing of a document, copy or page is completed.
  675.  
  676.  
  677. 5.3.14     Maximum Printer Buffer Size
  678.  
  679.    Personal Write fully exploits the Amiga's multitasking capabilities.
  680. The program can print while other operations are in progress. The process
  681. which prints in the background while the user works with the program is
  682. called "spooler". To activate the spooler it is sufficient to let it use
  683. some memory. When the spooler is working, Personal Write sends the texts
  684. to be printed to the spooler, rather than to the printer. In the meantime,
  685. the spooler sends the data to the printer, and will continue to do so
  686. while there is something to print, even if the user is already typing in a
  687. new document. The data transfer from Personal Write to the spooler is much
  688. faster than the one from the Amiga to the printer. While the spooler is
  689. printing, the user can even load, print, write and save other documents,
  690. or vary the size of the printer buffer itself.
  691.  
  692.    The amount of memory set by this parameter is the maximum memory which
  693. can be temporarily used by the spooler to store the data which has not yet
  694. been sent to the printer. Personal Write can send its data at very high
  695. speed to the spooler until maximum buffer memory is reached. The speed at
  696. which the data is sent to the spooler is higher than the speed at which
  697. the same data, without a spooler, would be sent to a printer's internal
  698. buffer or to a hardware spooler. If the parameter is set to 0, the spooler
  699. is not used. If it is set to 9999, the entire computer memory will be
  700. used, if necessary. The spooler never occupies more than the amount of
  701. memory necessary to temporarily store the data which has not yet been sent
  702. to the printer.
  703.  
  704.  
  705. 5.4        PostScript
  706.  
  707.    Personal Write has a built-in PostScript printer driver. This requester
  708. can be used to modify the parameters of the PostScript output.
  709.  
  710.    To use the PostScript driver, Personal Write must be able to access the
  711. "PostScript ®" file contained on the program disk. If, for example,
  712. Personal Write is installed on a hard disk, that file must be installed as
  713. well. Sections 1.15 ("Loading Personal Write"), 1.16 ("Automatic
  714. Installation: the InstallPWrite Program") and 6.5 ("Default Directory")
  715. explain how to use Personal Write from volumes or drawers other than the
  716. standard disk on which the program is shipped.
  717.  
  718.  
  719. 5.4.1      PostScript activated
  720.  
  721.    When this option is selected, Personal Write uses its own PostScript
  722. printer driver. All program parameters, and in particular the printer
  723. options (section 5.3) remain valid when Personal Write is printing a text
  724. on a PostScript printer. All print modes supported by Personal Write,
  725. including large, fine, superscript and subscript (section 6.4) modes are
  726. handled by the driver. The "Print Picture" function and the "Print ASCII"
  727. and "Print ANSI" save formats, however, are not affected in any way by the
  728. setting of this parameter.
  729.  
  730.    To obtain high quality results, the "Automatic font selection", "Letter
  731. quality", "Proportional characters", "Printer can justify" and "Send form
  732. feed" options of the printer settings (section 5.3) should be activated. A
  733. "Proportional adjust" value of 85% produces good results with most
  734. PostScript fonts used to print normal texts. These parameters are
  735. automatically set as suggested here when the PostScript option is selected
  736. for the first time.
  737.  
  738.    The settings of the "Multi-Strike" and "Use printer bell" options are
  739. not considered during PostScript output.
  740.  
  741.    The specified "Pitch" setting (section 5.3.6) is always used when text
  742. is printed with a fixed pitch font. Large text is printed at 5 characters
  743. per inch (cpi), pica means 10 cpi, elite stands for 12 cpi and fine text
  744. is printed at 17 cpi. It is not so easy to count the number of
  745. proportionally spaced characters which may appear in an inch. The
  746. PostScript driver modifies proportionally spaced text in such a way that
  747. "large" means visibly large text, and "fine" unquestionably fine text. The
  748. pica and elite print pitches maintain the default text proportions of the
  749. selected font.
  750.  
  751.    If the "Wait for page change" option is set, the program displays the
  752. usual requester to allow the user to insert a new sheet into the printer
  753. manually. Most PostScript printers automatically wait for the insertion of
  754. a sheet if the manual feed guide is used. This option can however be
  755. useful if it is often necessary to print on different sheets (e.g. the
  756. first page is to be printed with a different letterhead), but only an
  757. automatic sheet feeder is available.
  758.  
  759.    Multiple copies of the same page are printed noticeably more slowly if
  760. the "Wait for page change" option is set. This is caused by the fact that
  761. Personal Write must send the same page more than once, and that page must
  762. be processed each time by the PostScript driver, rather than being
  763. processed only once and then printed in more copies.
  764.  
  765.    The PostScript printer driver always tries to temporarily disable the
  766. printer's timeout function. In this way, the printer does not abort the
  767. printing if the user fails to insert a new sheet within the printer's
  768. default maximum wait time.
  769.  
  770.    If the "Send form feed" option (section 5.3.11) is not activated, the
  771. PostScript driver automatically starts to print on a new page when the
  772. text reaches the bottom of a page.
  773.  
  774.    Most PostScript printers can use a very large amount of their memory to
  775. store the data which must still be printed. It may happen that while the
  776. printer is processing the data in its buffer, and the buffer is full, the
  777. computer has to wait for several seconds before new data can be sent to
  778. the printer. This may trigger the Amiga timeout function unnecessarily,
  779. causing the display of the "Printer Trouble" operating system message. The
  780. "Resume" gadget of the message must be selected to continue.
  781.  
  782.    The PostScript prologue is a program written in the PostScript
  783. programming language which Personal Write sends to the printer before each
  784. print operation. It is therefore easy to understand how a document can be
  785. printed considerably faster with a single "Print Document" command than by
  786. executing the "Print Page" function for each page. In the latter case, the
  787. prologue has to be sent before each page. Using an Amiga with a standard
  788. 7.16 Mhz 68000 microprocessor, short texts are usually printed faster if
  789. the "Maximum printer spooler size" parameter (section 5.3.14) is set to 0.
  790. In this way, both the printer's buffer and an extra high-speed
  791. transmission of the PostScript prologue can be exploited. Multiple copies
  792. of an identical text can be printed at an even higher speed by setting the
  793. "Number of copies" parameter (section 5.3.8), rather than printing the
  794. same text more than once. The PostScript driver uses a special PostScript
  795. function to print multiple copies of the same page quickly.
  796.  
  797.    Three letters of the Amiga character set have no equivalent in the
  798. standard PostScript fonts. These are the Icelandic "thorn" and "eth", and
  799. the 'y' with an acute accent. The PostScript driver approximates these
  800. letters to the most similar available characters.
  801.  
  802.    When proportionally spaced fonts are used to print the text
  803. ("Proportional characters" option selected), the PostScript driver
  804. activates its unique "column detect" mode. This means that vertical
  805. alignment within tables of data is preserved even if the single items are
  806. preceded by other text on the same line. A word is recognized as "aligned"
  807. if it is immediately preceded by at least two spaces. Spaces at the
  808. beginning of a line do not count for this purpose (they are considered
  809. part of the left margin). If three or more lines without "aligned" words
  810. are printed, all column information is reset. The text in the line and
  811. within the columns must be left-aligned. Lines terminating with a
  812. paragraph sign are treated as left-aligned even if they are part of a
  813. justified paragraph.
  814.  
  815.    Certain combinations of letters are automatically substituted by the
  816. corresponding PostScript ligatures to improve the appearance and the
  817. readability of proportionally spaced text. The lowercase 'f' and 'i'
  818. letters in the "Times-Italic" font, for example, are elegantly merged
  819. together so that the dot of the 'i' is not printed on top of the 'f'.
  820.  
  821.    The PostScript printer driver may have to force text justification in
  822. such a way that the spaces between the words are far from the aesthetical
  823. optimum. This may happen, for example, if too many letters (e.g. more
  824. capital letters than usual) in a line exceed the average character width.
  825. If this happens frequently, the "Proportional adjust" parameter can be set
  826. to a higher value, modifying the line width accordingly. In such a case,
  827. it may be more important to reduce the font size. Conversely, the font
  828. size may be increased (or a new font, with different proportions, may be
  829. selected) if the spacing between the words is too high. This also makes
  830. the text more readable.
  831.  
  832.    The maximum total number of characters per line (i.e. document left
  833. margin plus characters per line) supported by the PostScript printer
  834. driver is 255.
  835.  
  836.  
  837. 5.4.2      Left Margin
  838.  
  839.    This parameter determines the minimum horizontal position on the sheet
  840. of paper to be used by the PostScript driver. Any document or paragraph
  841. left margin is relative to the position defined by this parameter.
  842.  
  843.    The value is expressed in units being 1/10 of a PostScript point, i.e.
  844. 1/720 of an inch (or 1/283 of a centimetre). The origin of the PostScript
  845. coordinate system is in the lower left corner of the sheet of paper. The
  846. exact position may vary from printer to printer.
  847.  
  848.  
  849. 5.4.3      Top Margin
  850.  
  851.    This parameter is used by the PostScript driver to position the
  852. baseline of the first line of text in a page. The same unit and coordinate
  853. system described in section 5.4.2 are used. This means that the position
  854. of the first line is measured from the bottom of the sheet.
  855.  
  856.  
  857. 5.4.4      Margin adjust unit
  858.  
  859.    This parameter controls the width of the PostScript spacing unit used
  860. with proportionally spaced text. This unit is used instead of the space
  861. character to determine the position of the left margin, the right margin
  862. and wherever two or more spaces appear in the text. The value (expressed
  863. in inches x 720, as explained in section 5.4.2) is multiplied by the
  864. "Proportional adjust" factor (section 5.3.4) before it is used by the
  865. PostScript driver.
  866.  
  867.    Using this unit, rather than the space character of each different
  868. font, guarantees that standard document margins and formatting can be
  869. maintained even if different fonts are used.
  870.  
  871.    This spacing unit is used only if the "Proportional characters" option
  872. is selected (section 5.3.4). If the option is set to NO, the width of the
  873. space character of the current font is used. If the option is set to NO,
  874. but a proportionally spaced font is specified for use with fixed pitch
  875. printing (this is allowed, even if formally incorrect), the width of the
  876. capital 'M' letter is used to set the margins.
  877.  
  878.  
  879. 5.4.5      PostScript fonts
  880.  
  881.    A different font can be used to print plain, italic, bold and italic
  882. bold text. Other text styles, like underlined text or superscript, are
  883. based on the same fonts. These four basic fonts can be selected by name
  884. and size. Four fonts can be chosen to print proportionally spaced text,
  885. and four more for fixed pitch text. The PostScript driver automatically
  886. chooses the proper font depending on the status of the "Proportional
  887. characters" printer option (section 5.3.4).
  888.  
  889.    Most PostScript printers have several built-in fonts. To select a font,
  890. the exact PostScript name of that font must be specified. Thirty-two
  891. PostScript font names are predefined by Personal Write. Four of these
  892. names identify fonts of the Courier type family, which is the only fixed
  893. pitch font supported by the majority of PostScript printers. The other
  894. font names refer to proportionally spaced fonts, and can be selected with
  895. the two arrow gadgets, which automatically place the appropriate names in
  896. the string gadgets. The default setting is a combination of Helvetica and
  897. Times fonts, which are the most commonly used PostScript fonts. A font
  898. name can also be typed manually in the string gadget associated with a
  899. particular text style. If the printer being used offers more fonts than
  900. those which are predefined by Personal Write, the new font names can be
  901. found in the printer's documentation. The names must be written very
  902. carefully. PostScript font names never contain space characters. The case
  903. of the letters is significant (i.e. capital letters are different from
  904. lower case letters). If a font which is not available on the printer is
  905. specified, any text requiring that font may be printed with a default font
  906. (typically Courier) or not be printed at all.
  907.  
  908.    The unit used to specify the font height is 1/72 of an inch (i.e. ten
  909. times the unit specified in section 5.4.2). This is almost identical to
  910. the printer's point (1/72.27 of an inch) and is a recognized standard for
  911. selecting the size of a font. Fonts normally used to print a document
  912. range between 10 and 12 points.
  913.  
  914. 5.4.6      Convert French quotes
  915.  
  916.   Unlike other systems, the Amiga uses a non-specific quote character for
  917. both left and right quotes. When this option of Personal Write is enabled,
  918. French quotes (mapped on the Amiga keyboard as <Alt>+<9> and <Alt>+<0>)
  919. can be typed instead of English left and right quotes. Since PostScript
  920. fonts have the equivalent English characters, Personal Write can translate
  921. them as indicated.
  922.  
  923.   If this setting is active, the same conversion is applied when exchanging
  924. data using the Macintosh character set (section 6.2). Amiga French quotes
  925. are converted to proper Macintosh left and right quotes (English quotes),
  926. and vice versa. Where other Cloanto packages capable of loading text files
  927. created with Personal Write exist in an environment supporting left and
  928. right quotes, this flag forces the software to interpret French quotes as
  929. English quotes.
  930.  
  931.   This option is document-specific. To make it a program default, the
  932. program settings must be saved (section 5.14).
  933.  
  934.  
  935. 5.5        User Interface Colours
  936.  
  937.    With this function, all user interface colours used by Personal Write
  938. can be changed.
  939.  
  940.    Personal Write uses eight different colours. A gadget on the top of the
  941. requester is associated with each of the colours. The colour to be
  942. modified can be chosen by selecting one of the gadgets.
  943.  
  944.    The triangle at the centre of the requester contains an area of the
  945. last colour which was selected, and is being modified. The triangle is
  946. useful for remembering the colour and checking the effects of the
  947. modifications.
  948.  
  949.    The three knobs labelled "Red", "Green" and "Blue" can be used to
  950. modify the levels of red, green and blue of the selected colour. Black,
  951. for example, has the three levels set to minimum, while the colour yellow
  952. has maximum levels of red and green, and blue at a minimum. Each of the
  953. three knobs can be moved while it is selected with the mouse, as explained
  954. in section 1.11.5.
  955.  
  956.    Three gadgets can be used to restore the standard default colours of
  957. Personal Write. The COLOUR1 and COLOUR2 gadgets restore the default values
  958. for colour monitors, while MONOCHROME does the same for monochrome
  959. screens. The different colour combinations have been designed to suit
  960. different types of monitor contrast and brightness and user taste.
  961.  
  962.    Only one of the three knobs (usually the one associated with the level
  963. of green) will modify the colours on most monochrome monitors. The two
  964. unused knobs should always be set at the same level as the active one, for
  965. each of the eight screen colours. If the knobs are aligned one over the
  966. other for each of the colours, the levels of red, green and blue sent to
  967. the monitor will each be the same as the other. This can eliminate the
  968. typical interference of some monochrome monitors (e.g. diagonal lines over
  969. coloured areas). The MONOCHROME gadget resets the colours keeping the red,
  970. green and blue levels aligned.
  971.  
  972.    In this documentation, the colours used by the program in certain
  973. circumstances are often mentioned. The colours described are, of course,
  974. the standard default colours, and can become meaningless if modified by
  975. the user.
  976.  
  977.    Section 5.12.6 explains how the colours used to display the document
  978. text and the text background can be reversed.
  979.  
  980.  
  981. 5.6        Picture Colours
  982.  
  983.    The requester used by this function is almost identical to the one used
  984. to set the user interface colours. There are no gadgets to restore the
  985. default colours, as the CANCEL gadget is sufficient to restore the
  986. picture's original colours.
  987.  
  988.    This requester is used to modify the colours of the picture which has
  989. been loaded. Sections 2.11 and 4.3.6 explain how to load and print a
  990. picture.
  991.  
  992.  
  993. 5.7        Sounds
  994.  
  995.    Personal Write audio consists of the sounds which are emitted when
  996. different functions are selected. The audio is stereo. The sound signals
  997. are emitted using different frequencies and volumes (for the F1-F10
  998. combinations) on the two audio channels.
  999.  
  1000.    The two YES/NO gadgets control the program's whole audio system.
  1001.  
  1002.    Two knobs, similar to the ones used to modify the colours, can be used
  1003. separately to set the volume of cue- and error-sound. The cue signals are
  1004. sounds emitted when a key is hit, or a gadget or menu item is selected.
  1005. All other sounds are error (or warning) signals. Whenever one of the two
  1006. knobs is released, a sound is emitted to demonstrate the effect of the new
  1007. volume.
  1008.  
  1009.    As explained in section 1.15, the audio only works if the program can
  1010. activate the CloantoAudio unit. Personal Write may have the audio unused
  1011. as a default to save memory on systems with 512 Kbytes of RAM and no
  1012. memory expansion.
  1013.  
  1014.  
  1015. 5.8        Language
  1016.  
  1017.    Personal Write was designed with users of different countries in mind.
  1018. Three requesters let the user select different combinations of document,
  1019. user interface and keyboard language.
  1020.  
  1021.  
  1022. 5.8.1      Document Language
  1023.  
  1024.    This requester is used to inform the program of the language in which
  1025. the current document is being written. This is necessary for the error
  1026. handling, the hyphenation, the automatic date label translation and the
  1027. conversion between different character sets to work properly.
  1028.  
  1029.    Different functions are activated in different languages. Some national
  1030. and local versions of Personal Write have different procedures activated.
  1031.  
  1032.    The information concerning the language in which a document is written
  1033. is stored and loaded with the document formatting data. The currently set
  1034. language is not modified when a document without formatting data (e.g.
  1035. ASCII o ANSI format) is loaded, so that a correct conversion/expansion of
  1036. national characters (section 6.2) in accordance with different language
  1037. rules is possible.
  1038.  
  1039.    This function can be selected by pressing <V> while the <Amiga> key is
  1040. held down.
  1041.  
  1042.  
  1043. 5.8.2      User Interface Language
  1044.  
  1045.    The user interface texts are displayed in menus, gadgets, requesters
  1046. and other messages. Most of these texts are stored in special files on the
  1047. disk which contains Personal Write. The user interface texts are
  1048. automatically loaded with Personal Write, but can also be selected and
  1049. loaded manually with this requester. Most interestingly, the files can be
  1050. loaded as plain text with the "Load Document" command of Personal Write,
  1051. modified, saved again, and immediately selected for the current user
  1052. interface. The keyboard shortcuts for the menu items are also stored in
  1053. these files, and can be modified using Personal Write.
  1054.  
  1055.    The files in which Personal Write stores the user interface texts all
  1056. begin with the name "CAWP3_UITX". A three-letter suffix is appended to the
  1057. file name, separated by a dot, to identify different national versions.
  1058. For example, "CAWP3_UITX.eng" contains the English texts. The "deu" and
  1059. "ita" suffixes respectively identify German and Italian text files, while
  1060. the "custom" suffix marks an entirely new language file created by the
  1061. user. Personal Write automatically builds the proper file names whenever a
  1062. user interface language is selected.
  1063.  
  1064.    When the PROCEED gadget is selected, the file associated with the
  1065. requested language is loaded. The user interface texts and the menu
  1066. shortcuts are instantly changed. Most national versions of Personal Write
  1067. contain only one language file, but additional files can be created by the
  1068. user, in any language, dialect, slang, or with simply a few minor changes
  1069. to the keyboard shortcuts.
  1070.  
  1071.    A few very important rules must be followed to create a new file with
  1072. the user interface texts. The easiest way to create such a file is to use
  1073. an existing file as a point of departure. The file must be stored as a
  1074. plain ASCII text file, without control sequences. Each line in the file
  1075. must contain either a valid text, a comment, or no characters at all
  1076. (blank line used as an optical separator). Leading space and TAB
  1077. characters are skipped. Comments begin with a ';' (ASCII decimal code 59)
  1078. sign. Each line (including the last one) must terminate with a LF
  1079. character (ASCII code 10).
  1080.  
  1081.    Special prefixes can be used to associate a shortcut with menu items.
  1082. These prefixes must be written immediately before the name of the menu
  1083. item they refer to, without separator spaces. A '#' (number sign)
  1084. character, followed by two characters in the range '1' to ':' (ASCII 49 to
  1085. 58) associates a double function key combination with the menu item (the
  1086. ':' character stands for <F10>). A '$' (dollar) sign can be followed by
  1087. one character in the same range ('1' to ':') to associate a single
  1088. function key with the menu item. A standard Amiga keyboard shortcut can be
  1089. associated with a menu item by writing the desired character, followed by
  1090. the '=' (equal) sign, just before the menu text. Letters, numbers and
  1091. other signs can be used for the Amiga shortcuts. Lower case letters and
  1092. capital letters are not considered different. Characters which have a
  1093. special use, as described here (e.g. '$' or '>'), cannot be used for Amiga
  1094. shortcuts. Characters whose ASCII code is greater than 126 may be handled
  1095. in an unexpected way by the Amiga operating system. A '>' (greater than)
  1096. sign can be placed at the beginning of the text (before any shortcuts) to
  1097. indicate that some space must be left in the menu item before the text, so
  1098. that the checkmark can be displayed.
  1099.  
  1100.    For example, to create a "F10-F9" shortcut for a "Print Page" menu, the
  1101. following text must be written: "#:9Print Page". A single function key
  1102. shortcut looks like: "$1Text". An Amiga key shortcut has the following
  1103. format: "W=Duplicate Line". A menu item that needs additional space for
  1104. the checkmark sign on the left of the text can be written as:
  1105. ">I=Insert".
  1106.  
  1107.    Double assignments of the same shortcut should be avoided, as only one
  1108. menu item can be associated with a character or function key combination.
  1109. The <F1>, <F4>, <F5>, <F6>, <F9>, <Esc> and <Help> keys have special
  1110. meanings in text editing, printing, string search/replace and error
  1111. handling operations. These local uses cannot be redefined.
  1112.  
  1113.    The user interface of Personal Write is extremely flexible, as it
  1114. automatically adapts itself to the lengths of the texts. The size of menus
  1115. is adjusted after the longest menu item. Menu subitems are placed on the
  1116. left or right of menus, depending on the available space. Gadgets and
  1117. texts in requesters are always aligned and linked correctly. It is however
  1118. necessary to consider some obvious limitations. A text on the title bar,
  1119. for example, should have a maximum length of 43 characters to be fully
  1120. visible on the title bar of a standard (640 dots horizontally) screen,
  1121. considering the depth gadgets and the cursor position information. The
  1122. maximum length for any user interface string is 80 characters. Texts
  1123. appearing in menus or requesters must not be too long to allow the
  1124. requester or menu to be displayed on the screen being used. Certain texts
  1125. can be displayed properly on an overscan screen, but may be too long for a
  1126. standard screen. Personal Write may issue an error message in such cases,
  1127. as for example if a requester becomes too large to appear in the current
  1128. screen.
  1129.  
  1130.    The texts contained in the files are grouped and ordered as follows:
  1131. menu texts, requester texts, gadget texts and message texts. The order in
  1132. which the texts appear in the file cannot be changed. Personal Write will
  1133. not load a file containing too many or not enough texts, or texts
  1134. containing unrecognized control codes.
  1135.  
  1136.    The original disk of Personal Write should not be used to experiment
  1137. with new user interface texts and/or shortcuts. The backup copy (section
  1138. 1.8) should be used instead. Since the disk containing Personal Write is
  1139. almost full, it may be necessary to delete some unused files (e.g. printer
  1140. drivers which are not needed) to make room for additional user interface
  1141. definition files. Novice users of the Amiga system should be particularly
  1142. careful when selecting the files to be deleted or overwritten, and
  1143. modifying the user interface of Personal Write.
  1144.  
  1145.    After the texts have been edited, they can be saved as usual with
  1146. Personal Write, as long as the ASCII save format is selected. If only
  1147. minor changes are applied to the file (e.g. only a few redefined
  1148. shortcuts), the original filename can be maintained, overwriting the
  1149. previous version (if that version is also stored somewhere else). If
  1150. however a completely new and original version is developed, it may be
  1151. advisable to use the "custom" suffix, as explained before.
  1152.  
  1153.    The look of the new user interface can be immediately verified by
  1154. recalling the "Options/Language/User Interface" function and selecting the
  1155. PROCEED gadget, after the appropriate language-gadget or the CUSTOM
  1156. gadget. The specified file is immediately used, even if it is the same
  1157. file which has already been loaded. This makes it possible to check the
  1158. effect of any changes one step at a time. An error message is displayed if
  1159. the load operation fails. In this case, the current user interface texts
  1160. are maintained.
  1161.  
  1162.    To permanently load the user interface texts from a file other than the
  1163. default file, the "Options/Save" function (section 5.14) can be used to
  1164. store the current parameters, which include the user interface language.
  1165. This causes the selected file to be loaded automatically whenever Personal
  1166. Write is started.
  1167.  
  1168.  
  1169. 5.8.3      Keyboard Language
  1170.  
  1171.    Not all Amiga computers use the same keyboards. Personal Write gives a
  1172. little help to the users of international (USA) keyboards who have to
  1173. write national characters of some languages, as illustrated in section
  1174. 1.12 and 7.3.
  1175.  
  1176.    The NATIONAL gadget should be selected if the keyboard contains all
  1177. symbols used in the document language. INTERNATIONAL can be selected if
  1178. the international (USA) keyboard is used.
  1179.  
  1180.    In some cases INTERNATIONAL can be set if the keyboard is neither the
  1181. international one, nor the one most suitable for the document which is
  1182. being written. Personal Write can give the support described in section
  1183. 1.12.5 only in some language/keyboard conditions.
  1184.  
  1185.    Section 1.12.1 explains how to use the SetMap command to inform the
  1186. Amiga operating system about the keyboard being used.
  1187.  
  1188.  
  1189. 5.9        Date and Time
  1190.  
  1191.   The current date and time should always be correct for some program and
  1192. operating system functions to work perfectly. The time can be set in
  1193. different ways (for example from the Shell, or with the Preferences
  1194. program), but this option of Personal Write is definitely easier to use.
  1195.  
  1196.    If the clock is set, this requester can always be popped up as if it
  1197. was a clock. Whenever a document is saved, the Amiga operating system
  1198. associates the current date and time data with the file containing the
  1199. text. This information can be read with the AmigaDOS "List" command.
  1200. Personal Write also uses this information to sort the file names by date
  1201. and time in the file requester. The time must be set correctly for these
  1202. functions to work properly.
  1203.  
  1204.    It is sufficient to select the parameter to be changed (e.g. the month)
  1205. with the left mouse button to set the date and time. Using the same mouse
  1206. button when the pointer is over one of the two arrows, the previously
  1207. selected parameter can be increased or decreased by one unit at a time.
  1208.  
  1209.    When the program default parameters are stored (section 5.14), the
  1210. battery backed-up clock is automatically updated on the Amiga 500 with
  1211. A501 expansion, on the Amiga 2000, 2500, 3000, 3500 and subsequent models.
  1212. The AmigaDOS "SetClock" command is used by Personal Write to save the date
  1213. and time.
  1214.  
  1215.    This function can be selected by pressing <U> while the <Amiga> key is
  1216. held down. The requester disappears when <Esc> or <Help> is pressed.
  1217.  
  1218.  
  1219. 5.10       Date Format
  1220.  
  1221.    This function is used to program the format used by the program to
  1222. display the date and time (the requester used by the function described in
  1223. section 5.9). The format defined here is also used when Personal Write
  1224. automatically replaces the "DATE" (and "DATUM", "FECHA", "DATA") labels.
  1225.  
  1226.  
  1227. 5.10.1     Order
  1228.  
  1229.    Three different date orders are possible: day-month-year,
  1230. year-month-day and month-day-year.
  1231.  
  1232.  
  1233. 5.10.2     Year Format
  1234.  
  1235.    The year can be represented with four or two digits.
  1236.  
  1237.  
  1238. 5.10.3     Month Format
  1239.  
  1240.    The month can be written as a word, truncated after the third letter of
  1241. the month name, or written as a number.
  1242.  
  1243.  
  1244. 5.10.4     Delimiter
  1245.  
  1246.    Different signs can be used to separate the year, month and day. A
  1247. space, a dash ('-'), a slash ('/'), a point ('.') and a comma (',') are
  1248. available.
  1249.  
  1250.  
  1251. 5.10.5     Label Date
  1252.  
  1253.    The options described above allow for many different date formats. But
  1254. these may not be sufficient to print a date in the most correct format of
  1255. a given language. For this reason, Personal Write can automatically write
  1256. a date in several languages, following the rules of the language in which
  1257. the document was written.
  1258.  
  1259.    If the STANDARD gadget is selected, Personal Write replaces the "DATE"
  1260. (or "DATUM", "FECHA", "DATA") label with the most appropriately formatted
  1261. current date text. This function always works in English, German, Italian,
  1262. Spanish, French and Dutch. Other national versions of the program may be
  1263. able to handle other languages.
  1264.  
  1265.    If the SPECIAL gadget is selected, the "DATE" (or "DATUM", "FECHA",
  1266. "DATA") label is translated with the current date in the format specified
  1267. by the other parameters of the requester. The format which is used is the
  1268. same used to display the requester described in section 5.9.
  1269.  
  1270.  
  1271. 5.11       Number Format
  1272.  
  1273.    The way in which Personal Write automatically writes both Arabic and
  1274. Roman numerals can be set with this requester.
  1275.  
  1276.  
  1277. 5.11.1     Arabic Numerals
  1278.  
  1279.    Arabic decimal numerals can be written using either the decimal point
  1280. ('.') or the decimal comma (','). Two gadgets can be used to choose which
  1281. of the two signs must be used by Personal Write when decimal numbers are
  1282. displayed.
  1283.  
  1284.  
  1285. 5.11.2     Roman Numerals
  1286.  
  1287.    The format used when Personal Write writes Roman numerals can be
  1288. specified using three gadgets. The classic format is the format most
  1289. widely used. The modern format is a variation of the classic format, where
  1290. some shorter representations are preferred to particularly long sequences.
  1291. Roman numbers in the compact format are always written in the most compact
  1292. possible format. The number 1996, for example, would be written in the
  1293. three formats respectively as: MCMXCVI, MXMVI an MVMI.
  1294.  
  1295.    Roman numerals are used by Personal Write for page numbering when
  1296. documents are printed.
  1297.  
  1298.  
  1299. 5.12       User Interface
  1300.  
  1301.    Several user interface values can be set in Personal Write. If there is
  1302. not enough memory to display this requester, Personal Write tries to close
  1303. the Workbench screen (section 5.12.9), assuming that this is the reason
  1304. for which the requester had to be displayed.
  1305.  
  1306.  
  1307. 5.12.1     Show Command Gadgets
  1308.  
  1309.    The ten gadgets at the bottom of the screen can be displayed or not. If
  1310. they are not, some more lines can be displayed on the screen, but the
  1311. selection of some commands using the mouse becomes a bit less immediate.
  1312. This parameter does not influence the working of the function keys.
  1313.  
  1314.   A scroll bar is now displayed on the botton of the screen together with
  1315. the other gadgets. The length of the bar is proportional to the contents
  1316. of the current text window. Cursor movement is as fine as allowed by mouse
  1317. resolution.
  1318.  
  1319.  
  1320. 5.12.2     Function Keys Activated
  1321.  
  1322.    The ten function keys are normally associated with the ten gadgets
  1323. which appear at the bottom of the screen.
  1324.  
  1325.    If one of the function keys is often pressed by mistake (which never
  1326. does harm, as it can be undone by pressing <F1>) the keys can also be
  1327. disactivated.
  1328.  
  1329.    It is also useful not to activate the function keys if other functions
  1330. or macro-sequences have been associated with the keys using special
  1331. programs.
  1332.  
  1333.    The status of this parameter does not modify the display or the working
  1334. of the ten gadgets at the bottom of the screen, which can still be
  1335. selected with the mouse. The function keys always work during search,
  1336. replace and print operations.
  1337.  
  1338.  
  1339. 5.12.3     Auto-Repeat Delete Keys
  1340.  
  1341.    Automatic repetition of the keys normally acts on graphic keys as well
  1342. as the <Del> and <BS> keys, as described in section 1.12.13. If immediate
  1343. and fast repetition is selected through the Preferences program, it may be
  1344. annoying (or even dangerous) if the repetition is also active on the keys
  1345. used to delete text (<Del> and <BS>).
  1346.  
  1347.    If the NO gadget is selected, the text deletion keys can be repeated
  1348. only if the keys are clearly released and pressed again.
  1349.  
  1350.  
  1351. 5.12.4     Display Cursor Position
  1352.  
  1353.    The cursor position and the paragraph formatting status character can
  1354. be displayed or not, depending on the setting of this parameter. If the
  1355. YES gadget is selected, the current cursor position is displayed on the
  1356. right of the title bar, in the following format: page, line and column
  1357. (character). An additional single character shows what the formatting of
  1358. the current paragraph is, as described in section 5.2.2.2.
  1359.  
  1360.  
  1361. 5.12.5     Show Paragraph signs
  1362.  
  1363.    Paragraph signs, already described in section 1.13.3, can be displayed
  1364. or not. If they are displayed, they appear as blue reversed 'P' signs.
  1365.  
  1366.    Paragraph signs do not appear when the text is output to the printer.
  1367.  
  1368.  
  1369. 5.12.6     Text Display
  1370.  
  1371.    By default Personal Write displays the text in black on white
  1372. background. The colours used to display document texts can be reversed. As
  1373. explained in section 5.5, all colours can be changed by the user. This
  1374. additional option can be used to selectively change only the two colours
  1375. used to display the text (i.e. black and white). If the NEGATIVE gadget is
  1376. selected, the background colour is set to the same colour as the screen
  1377. border.
  1378.  
  1379.  
  1380. 5.12.7     Initial Date and Time Set
  1381.  
  1382.    Personal Write can display the requester used to set the date and time
  1383. (section 5.9) immediately after the program is started. This can be
  1384. especially useful if the computer has no built-in clock. This parameter
  1385. can be used to decide whether the requester is to be displayed or not.
  1386.  
  1387.  
  1388. 5.12.8     Hide Mouse Pointer
  1389.  
  1390.    If this option is selected, the mouse pointer will disappear whenever
  1391. the user starts writing after moving to a new position in the text. At the
  1392. first mouse or cursor movement, or when a command is executed, the pointer
  1393. image is restored.
  1394.  
  1395.  
  1396. 5.12.9     Workbench Screen
  1397.  
  1398.    With this parameter, the user can manually close or re-open the
  1399. Workbench screen, normally used by Amiga to display disk icons, Shell
  1400. windows etc.
  1401.  
  1402.    The Workbench screen is public, and can be closed only if it does not
  1403. contain other windows than those used to display the contents of disks and
  1404. drawers. An error message is displayed if the screen cannot be closed or
  1405. opened (not enough chip memory).
  1406.  
  1407.    More than 40 Kbytes of RAM are freed when a PAL-size Workbench screen
  1408. of 256 lines, 640 pixels wide, with four colours (two bit planes) is
  1409. closed. Personal Write automatically tries to close the Workbench screen
  1410. if it does not find a memory expansion on a 512 Kbyte system.
  1411.  
  1412. 5.12.10    Font
  1413.  
  1414.   A fixed-width font other than Topaz 8 can now be used to display the text.
  1415. This may be useful, for example, if Personal Write is used in a higher
  1416. resolution mode, such as 640x480. The Personal Fonts Maker could be used,
  1417. for example, to automaticaly generate an 8x16 Topaz font by stretching the
  1418. original 8x8 font (if you use the PFM, remember to select the NoFilter.set
  1419. or the Amiga.set character set before loading Topaz 8).
  1420.  
  1421.  
  1422. 5.13       Video
  1423.  
  1424.    This requester contains the parameters which control the size and
  1425. resolution of the screen opened by Personal Write. All parameters have an
  1426. AUTO option, which means that the most appropriate setting is
  1427. automatically selected when the program starts, depending on the system
  1428. defaults and the available memory.
  1429.  
  1430.    Once the screen of Personal Write is open, its size is not modified.
  1431. Any changes to the video parameters become visible only after the
  1432. parameters are saved (section 5.14) and the program is re-started.
  1433. Personal Write automatically displays the "Save Parameters" requester
  1434. after the video settings are changed.
  1435.  
  1436.    Some settings work only partially, or do not work at all with some
  1437. versions of the Amiga custom chips and/or Amiga operating system. In most
  1438. cases, the selection of a mode which is not supported by the environment
  1439. in which the program is running simply has no effect, while the remaining
  1440. parameters are used normally. If the operating system does not allow the
  1441. selected screen to be opened (returning an error), Personal Write tries to
  1442. open a standard NTSC screen.
  1443.  
  1444.    If Personal Write is started from the Shell or CLI, the video mode can
  1445. be selected with one or more parameters written after the program name.
  1446. One or more modes can be activated by typing the corresponding
  1447. character-flags after the '-' (dash) sign. The characters are: 'n' (NTSC),
  1448. 'p' (PAL), 'x' (X-overscan), 'y' (Y-overscan), 'i' (interlace), 'v' (VGA)
  1449. and '2' (2024). For example, to start Personal Write with an interlaced
  1450. screen with vertical overscan
  1451.  
  1452.      PWrite -yi
  1453.  
  1454. must be written in the Shell or CLI. An optional filename may be written -
  1455. separated by a space - after the flags.
  1456.  
  1457.  
  1458. 5.13.1     Base Mode
  1459.  
  1460.    This parameter controls the NTSC/PAL mode setting. By default, Personal
  1461. Write recognizes the current mode automatically. The use of a different
  1462. mode can be forced with this parameter.
  1463.  
  1464.    Normally (with no overscan or interlace), an NTSC screen is 640 dots
  1465. wide and 200 lines high, while a PAL screen is 256 lines high. The
  1466. interlace mode doubles the number of lines. The overscan modes cause the
  1467. screen to be a bit wider and/or higher than normal. The A 2024 mode (which
  1468. requires an A 2024 monitor) also has NTSC and PAL variants.
  1469.  
  1470.  
  1471. 5.13.2     Extended Mode
  1472.  
  1473.    More recent versions of Amiga hardware allow extended screen modes to
  1474. be used. The Enhanced Chip Set (ECS), for example, makes it possible to
  1475. open a VGA (Productivity Mode) screen, while the A 2024 monitor (which
  1476. works with all versions of the Amiga) can display extra large (up to 1008
  1477. by 1024) screens.
  1478.  
  1479.    The VGA and A 2024 extended modes can be selected manually. By default,
  1480. Personal Write activates an extended mode if that is the system default.
  1481. An extended mode Workbench screen also activates a similar mode for the
  1482. screen of Personal Write. In some cases it may be unnecessary to have an
  1483. extra large screen for Personal Write, even if that is the system default.
  1484. The INHIBIT gadget can be selected in order not to open an extended mode
  1485. screen for Personal Write.
  1486.  
  1487.  
  1488. 5.13.3     Vertical Refresh Rate
  1489.  
  1490.    With some versions of the Amiga custom chips it is possible to program
  1491. the vertical video refresh rate. Most computer display technologies
  1492. currently in use do not show a fully persistent image. Instead, the
  1493. picture is displayed several times each second. The display can become
  1494. almost completely dark between the display of consecutive pictures. The
  1495. brain of the viewer, however, merges this "flashing" display into a
  1496. constant picture. A "flickering" image may be the result of a refresh rate
  1497. which is too low.
  1498.  
  1499.    The refresh rate should be as high as permitted by the technology being
  1500. implemented. Even if no flickering can be consciously perceived, lower
  1501. refresh rates cause more stress and fatigue to the eye and the brain.
  1502.  
  1503.    The default vertical video refresh rate on the Amiga is usually
  1504. determined by the setting of a jumper on the motherboard. The refresh rate
  1505. can be changed between 50 and 60 Hz (pictures per second) by modifying
  1506. this hardware setting. Multiscan (or "multisync") monitors automatically
  1507. adjust to this rate. Other monitors may require manual adjusting of the
  1508. V-Hold control, if they can display the picture at all.
  1509.  
  1510.    The default refresh rate for the NTSC video system is 60 Hz, while for
  1511. PAL it is 50 Hz. This is usually the same as the electrical power supply
  1512. frequency. The jumpers on the Amiga are set in a way that in the country
  1513. where the computer is used the picture can be displayed properly by a
  1514. simple monitor or TV set which requires the power supply frequency to be
  1515. equal to the vertical refresh rate.
  1516.  
  1517.    With some combinations of Amiga hardware and operating system, the
  1518. vertical refresh rate may be software-controlled. This parameter of
  1519. Personal Write modifies the vertical refresh rate, if this can be done on
  1520. the system being used.
  1521.  
  1522.  
  1523. 5.13.4     Frames per Second (A 2024)
  1524.  
  1525.    The A 2024 display can operate at different picture refresh rates. The
  1526. vertical video refresh rate always remains constant, but the rate at which
  1527. different complete video frames are sent by the computer to the monitor
  1528. may vary. While the computer is sending a new image, the A 2024 continues
  1529. to display the previous picture, stored in the monitor's memory.
  1530.  
  1531.    This option can be used to choose between a transfer rate of 10 or 15
  1532. full video pictures per second. Ten different images per second are
  1533. usually sufficient to keep the screen up to date if there are no fast
  1534. moving objects. If the mouse pointer is moved very quickly, for example,
  1535. it may appear to be moving stepwise, jumping from one position to the
  1536. next. This effect can be reduced by setting a rate of 15 full images per
  1537. second. This higher rate, however, may affect the overall system
  1538. performance, slowing down certain other activities of the computer.
  1539.  
  1540.  
  1541. 5.13.5     Overscan Screen
  1542.  
  1543.    Personal Write can use a non-standard region of the screen, called
  1544. overscan region. This region normally surrounds the screen used by
  1545. programs. Its size varies depending on the video mode, the hardware and
  1546. the operating system defaults. Under version 2.0 and beyond of the Amiga
  1547. operating system, the system "Text Overscan" region is used.
  1548.  
  1549.    The overscan zones at the sides and at the top and bottom of the screen
  1550. are always used by Personal Write if the YES gadgets of the horizontal and
  1551. vertical overscan parameters, respectively, are selected. Some more
  1552. columns and lines become available for text display. The options can be
  1553. set to NO if the overscan region is unnecessary, or to AUTO if the screen
  1554. must be opened in the system's default size (overscan or not), if the
  1555. available memory permits this.
  1556.  
  1557.    Under Amiga operating system versions prior to 2.0, the overscan mode
  1558. is not a standard system feature, and can cause some drawbacks. Not all
  1559. monitors can display the entire content of an overscan screen. Starting
  1560. with version 2.0 of the operating system it is possible to define the text
  1561. overscan area used by Personal Write, reducing or enlarging it as
  1562. necessary. The overscan mode can also interfere with the normal activity
  1563. of some peripheral equipment (e.g. hard disks). Personal Write recognizes
  1564. the operating system version and tries to minimize the side effects
  1565. accordingly.
  1566.  
  1567.  
  1568. 5.13.6     Interlaced Screen
  1569.  
  1570.    The number of video lines can be doubled if the interlace mode is
  1571. selected.
  1572.  
  1573.    This option usually increases the flickering of the screen. This is
  1574. caused by the fact that the Amiga video circuitry cannot display twice as
  1575. many lines as normal in a single video refresh pass: instead it refreshes
  1576. the odd and even video lines alternately.
  1577.  
  1578.    If the monitor (usually multisync or VGA) is connected to the video
  1579. output of a "Flicker Fixer" or "Display Enhancer" (as in the Amiga 3000),
  1580. the interlace mode is deinterlaced automatically. This makes it possible
  1581. to display twice as many video lines without visible interlace.
  1582.  
  1583.    An interlaced screen requires about twice as much screen memory as a
  1584. non-interlaced screen.
  1585.  
  1586.  
  1587. 5.14       Save
  1588.  
  1589.    All parameters can be saved. When Personal Write is started, it
  1590. searches for previously stored default values on the same disk from which
  1591. it is loaded. If the parameters are found, they will be used as default
  1592. values during the execution of the program. If the parameter file is not
  1593. found on that disk, Personal Write searches for any parameters stored in
  1594. all other storage devices which are mounted.
  1595.  
  1596.    This function stores all program parameters. The formatting data of the
  1597. document and first paragraph, audio, colours, user interface, file
  1598. requester, error handling etc. are among the values which are stored.
  1599.  
  1600.    It is necessary to select the gadget associated with the storage unit
  1601. containing the program which will have to read the values.
  1602.  
  1603.    By selecting PROCEED, the parameters are saved to the selected unit.
  1604. The current document and first-paragraph formattings are immediately used
  1605. as standard default values (also see sections 5.2 and 5.8.1).
  1606.  
  1607.   Device names are now saved by name. Full path names are stored for all
  1608. file requesters. The last path used for each requester is saved.
  1609.  
  1610.